Skip to main content

Detail Automatic Backup Config

This API returns the current automatic backup configuration, including its scope, destination, schedule, retention, and status.

Endpoint Details

URL/v1/backup/config
MethodGET
AuthorizationBearer Token

Request Headers

HeaderTypeDescription
Content-TypeStringMust be application/json

Response

Here is an example response after the request has been successfully processed:

Response
{
"data": {
"id": "49b51474-8bfb-4762-937c-144ccadb72d6",
"scopes": [
1,
2,
3,
4
],
"destination_type": 1,
"destination_path": "/tmp/backups/",
"schedule": {
"schedule_type": 1,
"time": "10:00"
},
"retention_days": 7,
"is_enabled": true,
"created_at": 1779332170,
"updated_at": 1784616261,
"last_run_at": 1784602800,
"next_run_at": -62135596800,
"created_by": "0a937c60-0ed4-4d06-870a-2e284b54287d",
"created_by_name": "Admin Aplikasi",
"encryption_key": "Q5AjARpdOecvFP6CH4HCAlks+OeB7oQr1mpRLDN6YUs=",
"s3_config": {}
}
}

Field Descriptions

FieldTypeDescription
idUUIDUnique identifier of the backup configuration
scopesArrayList of scope codes included in the backup
destination_typeIntegerType of backup destination
destination_pathStringPath where the backup files are stored
scheduleObjectSchedule configuration for the automatic backup
schedule.schedule_typeIntegerType of schedule used for the automatic backup
schedule.timeStringTime of day the backup runs (HH:MM)
schedule.weekly_daysArrayDays of the week the backup runs, used when schedule_type is weekly
schedule.monthly_datesArrayDates of the month the backup runs, used when schedule_type is monthly
retention_daysIntegerNumber of days backups are retained before removal
is_enabledBooleanIndicates whether the automatic backup is enabled
created_atIntegerCreation timestamp in Unix format
updated_atIntegerLast update timestamp in Unix format
last_run_atIntegerTimestamp of the last backup run in Unix format
next_run_atIntegerTimestamp of the next scheduled backup run in Unix format
created_byUUIDIdentifier of the user who created the configuration
created_by_nameStringDisplay name of the user who created the configuration
encryption_keyStringEncryption key used to encrypt the backup files
s3_configObjectS3 destination configuration, used when the destination is S3

info
  • A valid Bearer Token is required to access this endpoint.
  • The scopes array lists the data scopes included in the automatic backup. Supported scope codes are:
    • 1 = System Configuration
    • 2 = Keys
    • 3 = Audit Log
    • 4 = System Log
  • The schedule.schedule_type determines how often the automatic backup runs:
    • 1 = Daily
    • 2 = Weekly — the weekly_days array specifies which days of the week the backup runs
    • 3 = Monthly — the monthly_dates array specifies which dates of the month the backup runs
  • The weekly_days array uses the following codes:
    • 0 = Sunday
    • 1 = Monday
    • 2 = Tuesday
    • 3 = Wednesday
    • 4 = Thursday
    • 5 = Friday
    • 6 = Saturday
  • The encryption_key is required to restore the encrypted backup files. Store it securely.
  • The s3_config object is only populated when the destination_type is set to an S3 destination.
  • Unix timestamp fields can be converted to a human-readable date and time format as needed.